Constructs an FSRef for an object, given an FSRef for the parent directory, and a Unicode name.

OSErr PBMakeFSRefUnicodeSync (
    FSRefParam *paramBlock
);

paramBlock

A pointer to a parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function.

• ref

  On input, a pointer to the FSRef for the directory containing the object (the parent directory)

• nameLength

  On input, the length of the name in Unicode characters.

• name

  On input, a pointer to the Unicode name. The Unicode name must be a leaf name; partial or full pathnames are not allowed. If you have a partial or full pathname in Unicode, you will have to parse it yourself and make multiple FSMakeFSRef calls.

• textEncodingHint

  On input, a suggested text encoding to use for the name. If you pass kTextEncodingUnknown, the File Manager will use a default value.

• newRef

  On output, a pointer to an FSRef, if the result is noErr.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)